home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / comm / x00v150.zip / XU.DOC < prev    next >
Text File  |  1990-06-02  |  23KB  |  780 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.                                    X00 Utility (XU)
  33.  
  34.                          Copyright 1990,  by Raymond L. Gwinn
  35.                                  12469 Cavalier Drive
  36.                               Woodbridge, Virginia 22192
  37.  
  38.                                  All Rights Reserved
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.                                                                           i
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.                                      INTRODUCTION
  63.  
  64.           XU  is  a   utility  program  intended  to  support   the  Serial
  65.           Input/Output (SIO) device driver X00.
  66.  
  67.           XU  combines  several individual  utilities that  were previously
  68.           distributed  with X00.  XU  gives the user  the ability to change
  69.           most of the X00 command line  options that were specified in  the
  70.           CONFIG.SYS file,  or when  X00 was  installed as  a TSR.   Future
  71.           versions of XU will provide additional functions such as port/IRQ
  72.           re-mapping.
  73.  
  74.           Use this program at your  own risk.  No warranties  or guarantees
  75.           are given or implied.
  76.  
  77.           You  may  enter as  many  commands as  you  wish in  a  single XU
  78.           execution.   The  only limitation  is the  length of  DOS command
  79.           lines.
  80.  
  81.           All references in this manual to the 16550A apply to the 16550AF,
  82.           16550AFN,  16C551 aka  16551,  and 16C552  aka  16552.   See  the
  83.           appendix  in X00USER.DOC  for a  discussion on  the  various chip
  84.           types.
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.                                                                          ii
  93.  
  94.                                   TABLE OF CONTENTS
  95.  
  96.  
  97.           INTRODUCTION  . . . . . . . . . . . . . . . . . . . . . . . .   i
  98.  
  99.           BOOT  . . . . . . . . . . . . . . . . . . . . . . . . . . . .   1
  100.  
  101.           CAPTURE . . . . . . . . . . . . . . . . . . . . . . . . . . .   2
  102.  
  103.           FIFO  . . . . . . . . . . . . . . . . . . . . . . . . . . . .   3
  104.  
  105.           DTR . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   4
  106.  
  107.           DV  . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   5
  108.  
  109.           LOCK  . . . . . . . . . . . . . . . . . . . . . . . . . . . .   6
  110.                Valid baud rates . . . . . . . . . . . . . . . . . . . .   6
  111.                Valid parity . . . . . . . . . . . . . . . . . . . . . .   6
  112.                data bits per character  . . . . . . . . . . . . . . . .   6
  113.                stop bits  . . . . . . . . . . . . . . . . . . . . . . .   7
  114.  
  115.           NASTY . . . . . . . . . . . . . . . . . . . . . . . . . . . .   8
  116.  
  117.           PORT  . . . . . . . . . . . . . . . . . . . . . . . . . . . .   9
  118.  
  119.           SET . . . . . . . . . . . . . . . . . . . . . . . . . . . .    10
  120.  
  121.           STATUS or S . . . . . . . . . . . . . . . . . . . . . . . .    11
  122.  
  123.           USEBIOS . . . . . . . . . . . . . . . . . . . . . . . . . .    12
  124.  
  125.           WATCHCD . . . . . . . . . . . . . . . . . . . . . . . . . .    13
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.                                                                           1
  134.  
  135.  
  136.  
  137.  
  138.  
  139.  
  140.  
  141.  
  142.  
  143.  
  144.  
  145.  
  146.  
  147.  
  148.  
  149.  
  150.  
  151.  
  152.  
  153.                                          BOOT
  154.  
  155.           This function should cause a warm boot.  The BOOT functions works
  156.           in  most environments, including  DESQview on most  systems.  The
  157.           BOOT function will not work on some 386 systems running protected
  158.           mode software.
  159.  
  160.           An example of the usage is:
  161.  
  162.                                        XU BOOT
  163.  
  164.           One appropriate place  to use this  function is  in a batch  file
  165.           that  is controlling  an  automated system  like  a  BBS.   If  a
  166.           condition is detected that is considered by the user to be severe
  167.           enough, the BOOT command can be issued to restart the system.
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.                                                                           2
  176.  
  177.  
  178.  
  179.  
  180.                                        CAPTURE
  181.  
  182.           X00 is a  FOSSIL serial I/O device driver.   A FOSSIL is normally
  183.           entered (called)  using an 80x86  INT 14h.   This means  that the
  184.           vector  (pointer)  for interrupt  14h must  point  to X00.   Some
  185.           programs will alter the  interrupt 14h vector (pointer).   If the
  186.           INT 14h vector is changed, X00 may not function properly.
  187.  
  188.           Application  programmers please note that the  INT 14h vector can
  189.           be  avoided  by using  the HLLAPI  routines  included in  the X00
  190.           distribution file.
  191.  
  192.           The  CAPTURE function is provided to instruct X00 to take control
  193.           of, or to release the INT 14h vector.
  194.  
  195.           Examples of usage are:
  196.  
  197.                                    XU CAPTURE:ON
  198.  
  199.                                    XU CAPTURE:OFF
  200.  
  201.                                    XU CAPTURE
  202.  
  203.           CAPTURE:ON  means  that  X00  will take/re-take  the  vector  for
  204.           interrupt  14h.   That  is,  X00  will make  the  INT 14h  vector
  205.           (pointer) point to the X00 function dispatcher.  The value of the
  206.           old INT  14h vector  is saved.   X00  does not save  the INT  14h
  207.           vector if it already points to X00.
  208.  
  209.           CAPTURE:OFF  means that  X00 is  to release  the INT  14h vector.
  210.           When X00 is initialized,  or when a CAPTURE:ON is issued, the INT
  211.           14h  vector  is saved.   The  CAPTURE:OFF  function tells  X00 to
  212.           restore the  last INT  14h vector  that it saved.   It  should be
  213.           noted  that the  last  INT  14h  vector that  X00  saved  is  not
  214.           necessary the correct vector.  An explanation is beyond the scope
  215.           of  this  document.    CAPTURE:OFF  will  also  disable the  BIOS
  216.           emulator.   CAPTURE:OFF  does  not deactivate  any FOSSIL  active
  217.           ports.
  218.  
  219.           If  you  are having  problems with  a  FOSSIL aware  program, try
  220.           CAPTURE:ON  just  prior to  executing the  program.   If  you are
  221.           having problems  with a communications program that is not FOSSIL
  222.           aware, try CAPTURE:OFF just prior to executing the program.
  223.  
  224.           This function takes effect immediately upon execution.
  225.  
  226.  
  227.  
  228.  
  229.  
  230.  
  231.  
  232.                                                                           3
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.                                          FIFO
  240.  
  241.           This function is  provided to give the  user control of FIFOs  in
  242.           the  SIO  chip.   At  this  time the  only  FIFOed  chip that  is
  243.           supported is the 16550A  and later versions.  Other  FIFOed chips
  244.           are being worked on and will be supported in the future.
  245.  
  246.           Some early PS/2  systems had 16550 (non A) chips  installed.  X00
  247.           will identify the non A versions (and tell you that you have one)
  248.           but it will  not use the FIFOs.   The FIFOs of the  16550 (non A)
  249.           are not reliable.
  250.  
  251.           If  the SIO  chip is  not a  FIFOed device,  this command  has no
  252.           effect.
  253.  
  254.           Examples of usage are:
  255.  
  256.                                    XU FIFO:15
  257.  
  258.                                    XU FIFO:8
  259.  
  260.                                    XU FIFO:OFF
  261.  
  262.           X00  defaults to  8 for a  16550A.   If an invalid  FIFO value is
  263.           specified, the default value will be substituted.
  264.  
  265.           When  a number  parameter is  given, it  specifies the  number of
  266.           characters that can be loaded  into the transmit FIFO of  the SIO
  267.           chip.  The receive FIFO is always set at the maximum.
  268.  
  269.           The  FIFO:OFF  command disables  both  the  receive and  transmit
  270.           FIFOs.
  271.  
  272.           I have seen problems with the 16550A when the  FIFO is set to the
  273.           maximum of 16.   The problems go away with the FIFO  value set to
  274.           15.  If you are seeing an occasional error during file transfers,
  275.           try lowering the FIFO value.
  276.  
  277.           This  command will  not take  effect for  ports that  are already
  278.           FOSSIL  active.  Once the port is reactivated, the specified FIFO
  279.